home *** CD-ROM | disk | FTP | other *** search
/ 8bitfiles.net/archives / archives.tar / archives / genie-commodore-file-library / GEOSApps / KEYMAKER2.SFX / keymaker 2.0 doc (.txt) next >
GEOS ConVerT  |  1990-02-12  |  29KB  |  416 lines

  1. KeyMaker 2.0 doc0
  2. SEQ formatted GEOS file V1.0
  3. Ep8pinGC
  4. OP V2.0 or higherINT
  5. POSTERPRINTGC
  6. BLASTER'S CONVERTER V2.5
  7. KEYMAKER2.1
  8. KEYMAKER 2.0 DOC
  9. Write Image V2.1
  10. geoWrite    V2.1
  11. .Irv Cobb
  12. 5107 N. 15th St.
  13. Omaha, NE 68110
  14. *****
  15. **.****r**
  16. `*(@*
  17. *1****sA***9 V&******
  18. (more) =>
  19. ORNdes:
  20.     .byte    #$81
  21.     .byte    #$13
  22.     .word    DoGRP
  23.     .byte    #17
  24.     .word    Pressed
  25.     .byte    #0
  26. Pressed:    jmp    RstrFrmDialogue
  27. DoGRP:    jsr    i_BitmapUp
  28.     .word    CornGRP
  29.     .byte    64/8
  30.     .byte    32
  31. KeyMaker 2.0 is an application that allows the user to redefine almost any key on the 64 or 128 keyboard.
  32. KeyMaker is compatible with Geos 2.0 and Geos 128 2.0 in 40 column mode.  Full support of the 128 keyboard is included.
  33. (more) =>
  34. In 64 mode, the top half of the KeyMaker screen looks like this (128 users see 128 notes section):
  35. Notice that the "back arrow" icon is inverted.  This means it is curren
  36. In 64 mode, the top half of the KeyMaker screen looks like this (128 users see 128 notes section):
  37. Notice that the "back arrow" icon is inverted.  This means it is currently selected for editing.  The back arrow key is selected when KeyMaker is first run and after the use of LOAD, SAVE, and DEFAULT.
  38. Also note that the "shift lock" and "restore" keys are shaded.  These two keys cannot be edited within the Geos environment.
  39. Click on any key to select it.
  40. (more) =>
  41. Ccan be selected together with other keys.  These keys will change the value shown in the STATUS window next to "Current:
  42. Ccan be selected together with other keys.  These keys will change the value shown in the STATUS window next to "Current:".  When the CTRL and/or 
  43.  keys are highlighted, the FETCH, Default, and hex editing arrows have no effect.  This is because values for these keys are 
  44. calculated
  45.  by Geos rather than held in a lookup table.  Thus, they cannot be changed.  (Actually, the values for a few of the 
  46.  keys combinations are in a lookup table, but KeyMaker does not support them.  Sorry.)  All other icons on the KeyMaker screen will function normally whether or not these keys are selected.
  47. (more) =>
  48. Dkeys also can be used in conjunction with other keys.  As you might expect, This will select the shifted value of the key.  All of the icons on the KeyMaker screen function when SHIFT is selec
  49. Dkeys also can be used in conjunction with other keys.  As you might expect, This will select the shifted value of the key.  All of the icons on the KeyMaker screen function when SHIFT is selected.
  50. Note: some keys return the same value whether shifted or unshifted.  However, the shifted and unshifted values of these keys can be changed and made different from each other.
  51. (more) =>
  52. The lower half of the 
  53. The lower half of the KeyMaker screen looks like this:
  54. Let's consider the three sections of the STATUS box first.
  55. (more) =>
  56. The center section of the
  57. The center section of the STATUS box looks like this:
  58.      @Key:
  59.   Shows the key currently selected.  The key description will be in caps if the SHIFT key is selected, lower case if not.  Some of the abbreviations used for the non-alpha-numeric keys are not terribly intuitive.  If the abbreviations confuse you, look at the top half of the screen to see which key is inverted or see Appendices A and B.
  60.      @Default:
  61.   Shows the default value (in hex) of the key selected.
  62.      @Current:
  63.   Shows the current value of the key selected.  The value displayed will change when the CTRL and/or 
  64.  keys are selected, but the value in memory will not.
  65.      @Hex editing arrows:
  66. FClicking on these arrows will change the 
  67. current
  68.  value of the selected key.  The left arrows will change the high nibble, the right ones the low nibble.  
  69.      @These changes are made directly to the Geos lookup table and will remain in effect when you QUIT KeyMaker.
  70. Although KeyMaker uses hex values exclusively, I have tried to make it comprehensive enough that you don't need to know what the hex numbers mean to use them.  If you do need to convert hex to/from decimal, Appendix E includes both values for all the keyboard keys [$01 - $7e (1 - 126)]
  71. (more) =>
  72. The left side of the STATUS box looks like this:
  73. Clicking on the STASH icon will save the 
  74.      @current
  75.  key valu
  76. The left side of the STATUS box looks like this:
  77. Clicking on the STASH icon will save the 
  78.      @current
  79.  key value to a buffer.
  80. Clicking on the FETCH icon will replace the 
  81.      @current
  82.  key value with the value in the buffer.
  83. The buffer status indicator box:
  84. Iwill be totally inverted after a STASH.  After the first FETCH from the buffer, the indicator box will be half inverted.  This gives you a visual indicator of what you have done with the buffer.
  85. The CORNFIELD icon:
  86. Jwill show you the credit dialog box for KeyMaker (similar to page one of these docs.)
  87. (more) =>
  88. The right side of the STATUS box looks like this:
  89. Clicking on the 
  90. The right side of the STATUS box looks like this:
  91. Clicking on the Default icon will return the 
  92.      @current
  93.  key value to its default.  Do not confuse this icon with the 
  94.      @Default
  95.  icon which is outside the STATUS box!
  96. (more) =>
  97. The icons on the right side of the bottom of the screen function as follows:
  98. geos:    Puts up a dialog box showing the Desk Accessories avai
  99. The icons on the right side of the bottom of the screen function as follows:
  100. geos:    Puts up a dialog box showing the Desk Accessories available on disk.  Second drive and disk switching are also supported.
  101.      @Default:    
  102. Returns all keys on the keyboard to their default Geos values.  This action is NOT reversible without re-editing or LOADing a KeyMaker data file.  Be careful not to confuse this 
  103.      @Default
  104.  icon with the Default icon in the STATUS box!
  105.      @Save:
  106.     Saves your customized keyboard setup to a data file.  KeyMaker uses AUTO_EXEC files as data files.  SAVE creates a stand-alone Geos file that will install your custom keyboard setup when double-clicked from the DeskTop (or at boot time if placed on your boot disk).
  107.      @Load:
  108.     Loads KeyMaker data files for editing.  LOADing a data file will change the values of all keys to those specified in the data file.  These changes are made directly to the lookup table and will remain in effect when you QUIT KeyMaker.
  109.      @Quit:
  110.     Clicking on the QUIT icon will exit KeyMaker.  Upon exiting, the keyboard will be configured exactly as specified by the 
  111.      @current
  112.  values of all keys.
  113. (more) =>
  114.      @128 Notes
  115. The upper part of the screen will include key icons representing the 128's extra keys:
  116. Kkeys will appear in their correct place at the top of the keyboard.  Note that the CAPS LOCK and 40/80 keys are shaded.  They cannot be edited.
  117. The keypad will appear underneath the space bar icon like this:
  118. Keypad keys have their own spots in the lookup table, even though they duplicate keys on the main keyboard.  Thus their values can be changed independently.  In the STATUS box, keypad keys are represented with a "k" suffix to differentiate between the keypad and main keyboard:
  119.      @Key:
  120.  3     (3 key on main keyboard above "w" and "e")
  121.      @Key:
  122.  3  k  (3 key on keypad)
  123. AUTO_EXEC data files created in 128 mode will do nothing if run in 64 mode (and vice versa).  They can be distinguished by the "64" or "128" in the icon.  Keymaker will load any data file regardless of which mode it is being run in. If a 128 file is LOADed in 64 mode and then SAVEd, it will have been converted to a 64 AUTO_EXEC file and the keypad data will be lost.  64 mode data files can be loaded in 128 mode, but the effects on the extra 128 keys are unpredictable.
  124. (more) =>
  125.      @Programmers' notes:
  126. Sometimes Geos software reads the keyboard directly without looking in the queue.  An example is the DeskTop's 
  127.  SHIFT A combination which switches drive C and drive A.  
  128.      @Programmers' notes:
  129. Sometimes Geos software reads the keyboard directly without looking in the queue.  An example is the DeskTop's 
  130.  SHIFT A combination which switches drive C and drive A.  
  131.  SHIFT A has a value of $c1.  However, if you define a key as $c1, the Desktop will respond to it as if you pressed 
  132.  A (without the shift).
  133. Profuse thanks to Mike Schell for his file documenting the Geos keyboard routines.  KeyMaker would have been impossible without his work.
  134. Even though I have yet to make a dime on the "Shareware Concept", I'll ask again . . .
  135. KeyMaker 2.0 is shareware.  If you get significant use from this program (and remember that a data file may be used every time you boot), please send $5.00 (I'm really not greedy, but I 
  136.  use the encouragement!) to:
  137.      @Irv Cobb
  138.      @5107 N 15th St.
  139.      @Omaha, NE  68110
  140. and thanks!
  141. (more) =>
  142. (more) =>
  143. will have been converted to a 64 AUTO_EXEC file and the keypad data will be lost.  64 mode data files can be loaded in 128 mode, but the effects on the extra 128 keys are unpredictable.
  144. (more)
  145.      @Appendix A
  146. Unshifted Key Abbreviations
  147. del    delete    ret    return
  148. crt    cursor right    cdn    cursor down
  149. lb    british pound    hom    home
  150. ^     up arrow    bac    back arrow
  151. spc    space    stp        stop
  152.      @128 only:
  153. hlp    help    tab    tab
  154. 1 k    keypad 1    2 k    keypad 2
  155. 3 k    keypad 3    4 k    keypad 4
  156. 5 k    keypad 5    6 k    keypad     6
  157. 7 k    keypad 7    8 k    keypad 7
  158. 9 k    keypad 9    0 k    keypad 0
  159. + k    keypad plus    - k    keypad minus
  160. . k    keypad period    nsc    no scroll
  161. esc    escape    lfd    line feed
  162. ent    enter    alt    alt
  163. up    cursor up *    dwn    cursor down *
  164. lef    cursor left *    rgt    cursor right *
  165. * On the 128, the cursor keys on the upper level of the keyboard can be defined separately from those on the main keyboard.
  166. (more) =>
  167.      @Appendix B
  168. Shifted Key Abbreviations
  169. INS    insert (shift delete)    RET    return
  170. CLF    cursor left    CUP    cursor up
  171. LB    british pound    CLR    clear (shift home)
  172. ^     up arrow    BAC    back arrow
  173. SPC    space    RUN        run (shift stop)
  174. sh0    shift zero    sh+    shift plus
  175. sh-    shift minus    sh@    shift @
  176. sh*    shift asterisk    sh=    shift equal sign
  177. QUO    quotes (shift 2)    sh^    shift up arrow
  178.      @128 only:
  179. HLP    help    TAB    tab
  180. 1 K    keypad 1    2 K    keypad 2
  181. 3 K    keypad 3    4 K    keypad 4
  182. 5 K    keypad 5    6 K    keypad     6
  183. 7 K    keypad 7    8 K    keypad 7
  184. 9 K    keypad 9    0 K    keypad 0
  185. + K    keypad plus    - K    keypad minus
  186. . K    keypad period    NSC    no scroll
  187. ESC    escape    LFD    line feed
  188. ENT    enter    ALT    alt
  189. UP    cursor up *    DWN    cursor down *
  190. LFT    cursor left *    RGT    cursor right *
  191. * On the 128, the cursor keys on the upper level of the keyboard can be defined separately from those on the main keyboard.
  192. (more) =>
  193.      @Appendix C
  194. Unshifted Key Values
  195. (in the order they appear in the look
  196.      @Appendix C
  197. Unshifted Key Values
  198. (in the order they appear in the lookup matrix)
  199. del    ret    crt    f7    f1    f3    f5    cdn
  200. $1d    $0d    $1e    $0e    $01    $03    $05    $11
  201. 3    w    a    4    z    s    e    ---
  202. $33    $77    $61    $34    7a    $73    $65    ---
  203. 5    r    d    6    c    f    t    x
  204. $35    $72    $64    $36    $63    $66    $74    $78
  205. 7    y    g    8    b    h    u    v
  206. $37    $79    $67    $38    $62    $68    $75    $76
  207. 9    i    j    0    m    k    o    n
  208. $39    $69    $6a    $30    $6d    $6b    $6f    $6e
  209. +    p    l    -    .    :    @    ,
  210. $2b    $70    $6c    $2d    $2e    $3a    $40    $2c
  211. lb    *    ;    hom    ---    =    ?    /
  212. $08    $2a    $3b    $12    ---    $3d    $5e    $2f
  213. 1    bac    ---    2    spc    ---    q    stp
  214. $31    $14    ---    $32    $20    ---    $71    $16
  215. 128 Version Only:
  216. hlp    8    5    tab    2    4    7    1
  217. $19    $38    $35    $09    $32    $34    $37    $31
  218. esc    +    -    lfd    ent    6    9    3
  219. $1b    $2b    $2d    $0a    $0b    $36    $39    $33            
  220. alt    0    .    up    dwn    lft    rgt    nsc
  221. $1a    $30    $2e    $10    $11    $08    $1e    $07
  222. (more) =>
  223.      @Appendix D
  224. Shifted Key Values
  225. (in the order they appear in the lookup matrix)
  226. INS    RET    CLF    F8    F2    F4    F6    CUP
  227. $1c    $0d    $08    $0f    $02    $04    $06    $10
  228. #    W    A    $    Z    S    E    ---
  229.      @Appendix D
  230. Shifted Key Values
  231. (in the order they appear in the lookup matrix)
  232. INS    RET    CLF    F8    F2    F4    F6    CUP
  233. $1c    $0d    $08    $0f    $02    $04    $06    $10
  234. #    W    A    $    Z    S    E    ---
  235. $23    $57    $41    $24    $5a    $53    $45    ---
  236. %    R    D    &    C    F    T    X
  237. $25    $52    $44    $26    $43    $46    $54    $58
  238. '    Y    G    (    B    H    U    V
  239. $27    $59    $47    $28    $42    $48    $55    $56
  240. )    I    J    0    M    K    O    N
  241. $29    $49    $4a    $30    $4d    $4b    $4f    $4e
  242. +    P    L    -    >    [    @    <
  243. $2b    $50    $4c    $2d    $3e    $5b    $40    $3c
  244. LB    *    ]    CLR    ---    =    ^    ?
  245. $18    $2a    $5d    $13    ---    $3d    $5e    $3f
  246. !    BAC    ---    "    SPC    ---    Q    RUN
  247. $21    $14    ---    $22    $20    ---    $51    $17
  248.      @128 Version Only:
  249. HLP    8    5    TAB    2    4    7    1
  250. $19    $38    $35    $09    $32    $34    $37    $31
  251. ESC    +    -    LFD    ENT    6    9    3
  252. $1b    $2b    $2d    $0a    $0b    $36    $39    $33
  253. ALT    0    .    UP    DWN    LFT    RGT    NSC
  254. $1a    $30    $2e    $10    $11    $08    $1e    $07
  255.      @Appendix E
  256. Geos ASCII Codes ($01-$3f)
  257. Key    Hex    Dec
  258. f1    $01    1
  259. F2    $02    2
  260. f3    $03    3
  261. F4    $04    4
  262. f5    $05    5
  263. F6    $06    6
  264. nsc    $07    7    128 only
  265. clf    $08    8
  266. tab    $09    9    128 only
  267. lfd    $
  268.      @Appendix E
  269. Geos ASCII Codes ($01-$3f)
  270. Key    Hex    Dec
  271. f1    $01    1
  272. F2    $02    2
  273. f3    $03    3
  274. F4    $04    4
  275. f5    $05    5
  276. F6    $06    6
  277. nsc    $07    7    128 only
  278. clf    $08    8
  279. tab    $09    9    128 only
  280. lfd    $0a    10    128 only
  281. ent    $0b    11    128 only
  282.     $0c    12    no apparent Geos function
  283. ret    $0d    13
  284. f7    $0e    14
  285. F8    $0f    15
  286. cup    $10    16
  287. cdn    $11    17
  288. hom    $12    18
  289. CLR    $13    19
  290. bac    $14    20
  291.     $15    21    no apparent Geos function
  292. stp    $16    22
  293. RUN    $17    23
  294. lb    $18    24
  295. hlp    $19    25    128 only
  296. alt    $1a    26    128 only
  297. esc    $1b    27    128 only
  298. INS    $1c    28
  299. del    $1d    29
  300. crt    $1e    30
  301.     $1f    31      SHIFT,
  302. ,CTRL (not supported by KeyMaker)
  303. spc    $20    32
  304. !    $21    33
  305. "    $22    34
  306. #    $23    35
  307. $    $24    36
  308. %    $25    37
  309. &    $26    38
  310. '    $27    39
  311. (    $28    40
  312. )    $29    41
  313. *    $2a    42
  314. +    $2b    43
  315. ,    $2c    44
  316. -    $2d    45
  317. .    $2e    46
  318. /    $2f    47
  319. 0    $30    48
  320. 1    $31    49
  321. 2    $32    50
  322. 3    $33    51
  323. 4    $34    52
  324. 5    $35    53
  325. 6    $36    54
  326. 7    $37    55
  327. 8    $38    56
  328. 9    $39    57
  329. :    $3a    58
  330. ;    $3b    59
  331. <    $3c    60
  332. =    $3d    61
  333. >    $3e    62
  334. ?    $3f    63
  335. (more) =>
  336.      @Appendix E (cont)
  337.  Geos
  338.      @Appendix E (cont)
  339.  Geos ASCII Codes $40-$7e
  340. Key    Hex    Dec
  341. @    $40    64
  342. A    $41    65
  343. B    $42    66
  344. C    $43    67
  345. D    $44    68
  346. E    $45    69
  347. F    $46    70
  348. G    $47    71
  349. H    $48    72
  350. I    $49    73
  351. J    $4a    74
  352. K    $4b    75
  353. L    $4c    76
  354. M    $4d    77
  355. N    $4e    78
  356. O    $4f    79
  357. P    $50    80
  358. Q    $51    81
  359. R    $52    82
  360. S    $53    83
  361. T    $54    84
  362. U    $55    85
  363. V    $56    86
  364. W    $57    87
  365. X    $58    88
  366. Y    $59    89
  367. Z    $5a    90
  368. [    $5b    91
  369. \    $5c    92    
  370. /  (not supported by KeyMaker)
  371. ]    $5d    93
  372. ^    $5e    94
  373. _    $5f    95    
  374.  -  (not supported by KeyMaker)
  375. `    $60    96    
  376.  @  (not supported by KeyMaker)
  377. a    $61    97
  378. b    $62    98
  379. c    $63    99
  380. d    $64    100
  381. e    $65    101
  382. f    $66    102
  383. g    $67    103
  384. h    $68    104
  385. i    $69    105
  386. j    $6a    106
  387. k    $6b    107
  388. l    $6c    108
  389. m    $6d    109
  390. n    $6e    110
  391. o    $6f    111
  392. p    $70    112
  393. q    $71    113
  394. r    $72    114
  395. s    $73    115
  396. t    $74    116
  397. u    $75    117
  398. v    $76    118
  399. w    $77    119
  400. x    $78    120
  401. y    $79    121
  402. z    $7a    122
  403. {    $7b    123    
  404.  :  (not supported by KeyMaker)
  405. |    $7c    124    
  406.  ^  (not supported by KeyMaker)
  407. }    $7d    125    
  408.  ;  (not supported by KeyMaker)
  409. ~    $7e    126    
  410.  *  (not supported by KeyMaker)
  411. CLR    ---    =    ^    ?
  412. $18    $2a    $5d    $13    ---
  413. NL    2@
  414. NL    2@
  415. I&d4 
  416.